home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / ppmquant.1 < prev    next >
Text File  |  1995-07-25  |  4KB  |  133 lines

  1.  
  2.  
  3.  
  4.      ppppppppmmmmqqqquuuuaaaannnntttt((((1111))))     XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11112222 JJJJaaaannnnuuuuaaaarrrryyyy 1111999999991111))))      ppppppppmmmmqqqquuuuaaaannnntttt((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           ppmquant - quantize the colors in a portable pixmap down to
  10.           a specified number
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ppppppppmmmmqqqquuuuaaaannnntttt [----ffffllllooooyyyydddd|----ffffssss] _n_c_o_l_o_r_s [_p_p_m_f_i_l_e]
  14.           ppppppppmmmmqqqquuuuaaaannnntttt [----ffffllllooooyyyydddd|----ffffssss] ----mmmmaaaapppp _m_a_p_f_i_l_e [_p_p_m_f_i_l_e]
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.           Reads a portable pixmap as input.  Chooses _n_c_o_l_o_r_s colors to
  18.           best represent the image, maps the existing colors to the
  19.           new ones, and writes a portable pixmap as output.
  20.  
  21.           The quantization method is Heckbert's "median cut".
  22.  
  23.           Alternately, you can skip the color-choosing step by
  24.           specifying your own set of colors with the ----mmmmaaaapppp flag.  The
  25.           _m_a_p_f_i_l_e is just a _p_p_m file; it can be any shape, all that
  26.           matters is the colors in it.  For instance, to quantize down
  27.           to the 8-color IBM TTL color set, you might use:
  28.               P3
  29.               8 1
  30.               255
  31.                 0   0   0
  32.               255   0   0
  33.                 0 255   0
  34.                 0   0 255
  35.               255 255   0
  36.               255   0 255
  37.                 0 255 255
  38.               255 255 255
  39.           If you want to quantize one pixmap to use the colors in
  40.           another one, just use the second one as the mapfile.  You
  41.           don't have to reduce it down to only one pixel of each
  42.           color, just use it as is.
  43.  
  44.           The ----ffffllllooooyyyydddd/----ffffssss flag enables a Floyd-Steinberg error
  45.           diffusion step.  Floyd-Steinberg gives vastly better results
  46.           on images where the unmodified quantization has banding or
  47.           other artifacts, especially when going to a small number of
  48.           colors such as the above IBM set.  However, it does take
  49.           substantially more CPU time, so the default is off.
  50.  
  51.           All flags can be abbreviated to their shortest unique
  52.           prefix.
  53.  
  54.      RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  55.           "Color Image Quantization for Frame Buffer Display" by Paul
  56.           Heckbert, SIGGRAPH '82 Proceedings, page 297.
  57.  
  58.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  59.           ppmquantall(1), pnmdepth(1), ppmdither(1), ppm(5)
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 9/7/93)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ppppppppmmmmqqqquuuuaaaannnntttt((((1111))))     XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11112222 JJJJaaaannnnuuuuaaaarrrryyyy 1111999999991111))))      ppppppppmmmmqqqquuuuaaaannnntttt((((1111))))
  71.  
  72.  
  73.  
  74.      AAAAUUUUTTTTHHHHOOOORRRR
  75.           Copyright (C) 1989, 1991 by Jef Poskanzer.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 9/7/93)
  130.  
  131.  
  132.  
  133.